home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 2 / Ultimedia 2.iso / tools / grafiktools / showgif / showgif.doc < prev    next >
Text File  |  1994-07-18  |  6KB  |  195 lines
  1.  
  2.  
  3.             =========================
  4.  
  5.                  ShowGIF V1.2
  6.  
  7.             =========================
  8.  
  9.  
  10.                 July 4, 1994
  11.  
  12.  
  13.           Copyright (c) 1994 by Roman Hiestand
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Copyright notice
  20. ----------------
  21.  
  22. The program ShowGIF and its documentation  are written and copyrighted by
  23. Roman Hiestand. They may be distributed freely providing the following
  24. restrictions are satisfied:
  25.  
  26. - Distributors may not charge more than the cost of a diskette used in
  27.   the distribution of this program.
  28.  
  29. - Distributors may only distribute the unmodified copy of the original
  30.   program,  source  file, along with it's documentation, and copyright
  31.   notices intact.
  32.  
  33. - Commercial  distribution  is  only  possible with written permission
  34.   from the author.
  35.  
  36.  
  37. Disclaimer
  38. ----------
  39.  
  40. This program and its documentation is provided "as is". No warranties are made
  41. with respect to the accuracy, reliability, performance or operation of this
  42. software and information. You are using this program at your own risk. The author
  43. is not liable for any damages that may have been caused by using this software.
  44.  
  45.  
  46.  
  47. Description
  48. -----------
  49.  
  50. ShowGIF is, as the name says, a GIF viewer for the Picasso-II graphics board of Village
  51. Tronic.
  52. The program can be started from CLI or Workbench with one or more file names/icons.
  53. If the program cannot load an image (because you didn't submit a filename or the file
  54. doesn't exist), a file requester pops up.
  55. It is meant to be fast and short, not user-friendly. This means, there are no options
  56. until now. Maybe in the next release.
  57. ShowGIF has been started as a programming exercise in Oberon. After a couple of days,
  58. it worked; but kinda slow. So I translated it into Assembler. It is very much easier
  59. translating an existing and running program than writing an assembly program from
  60. scratch. After another couple of days programming and optimising, ShowGIF was born.
  61.  
  62.  
  63. Usage
  64. -----
  65.  
  66. From CLI: ShowGIF Image [...]
  67.  
  68. Template: FILES/M
  69.  
  70. The program can also be started from Workbench: as default tool or with multiple
  71. selection. No file requester until now.
  72.  
  73. If no filenames are given, a file-requester pops up.
  74.  
  75. The program can be stopped by hitting any key or mousebutton.
  76.  
  77.  
  78. Features
  79. --------
  80.  
  81. - fully programmed in assembler
  82. - uses a file buffer (currently 50 KB, planned to be user-definable)
  83. - CLI or WB start
  84. - very system-friendly
  85. - (nearly) pure
  86. - can be aborted at anytime (except during a crash ... :-) )
  87. - supports interlaced images (since V1.1)
  88. - no 'light' background (since V1.1)
  89. - file requester (since V1.2)
  90.  
  91.  
  92. About being 'nearly' pure:
  93. You can safely make this program resident. You can run ShowGIF as many times as you want,
  94. if you run one *after* the other. A problem *can* arise when you run two or more ShowGIF's
  95. at the same time. The only part that is not pure is where it opens the screen and the
  96. window. This time is quite short, and it is very unlikely to happen that two ShowGIF's
  97. interfere. By the way, have you ever tried to view two images at the very same time ?
  98. (Not very useful, ay ?)
  99.  
  100.  
  101. Requirements
  102. ------------
  103.  
  104. Kick 2.0 and vilintuisup.library version > 2.0.
  105.  
  106.  
  107. Bugs
  108. ----
  109.  
  110. - well, not really a bug: if started from workbench, no error messages are printed
  111.  
  112. I could only test it on my machine (A3000 with Kick 2.0). No Enforcer hits have been found.
  113. If you find a bug, please report it to me together with as much information as possible
  114. that could help me to fix it: your computer, configuration, kick version and so on.
  115.  
  116.  
  117. Future plans
  118. ------------
  119.  
  120. - full support of the GIF89a standard (multiple images, local color tables, texts etc.)
  121. - a bunch of options (FileBufSize, Verbose ...)
  122. - view images larger than the largest screen available
  123. - reduce colors
  124. - faster ...
  125.  
  126.  
  127. Notes about this program
  128. ------------------------
  129.  
  130. The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated.
  131. GIF(sm) is a Service Mark property of CompuServe Incorporated.
  132. This program has been fully written in assembler. It is therefore very short and quite fast.
  133. The GIF decoding algorithm is mainly based on the c-source (jrdgif.c) of the jpeg software
  134. (version 4 of the jpeg software release), which itself is based on giftoppm. Many thanks
  135. to the JPEG group !
  136.  
  137. ShowGIF is pretty much optimised. Not only by the assembler (phxass is GREAT! Thanks to 
  138. F. Wille), but also by hand. At this time, I can't think of another optimisation.
  139. When I compared ShowGIF to VT, I was pretty surprised because I didn't expect VT being so
  140. fast. Maybe I overlooked a couple of optimisations ...
  141.  
  142.  
  143.  
  144. Comparison table
  145. ----------------
  146. (Not representative)
  147.  
  148.  
  149.            ShowGIF V1.2        ViewGIF 1.6      VT_Picasso V2.1     ReadGIF V1.210
  150.                     from VillageTronic                (J.Weinelt)
  151.            ------------------------------------------------------------------------
  152.  
  153. Executable size        2796          19376             84584         11020
  154. display time (~,secs)      15             33            15            34
  155. Mem needed (~)         1.12 MB         1.2 MB           2.41 MB        1.1 MB
  156. (including display
  157.  memory)
  158.  
  159. Attention: the values for mem in the old (V1.0) doc were wrong. These here should be more
  160. precise.
  161.  
  162. (Time & mem are measured with 'globe.gif' (547365 bytes, 912x900), a picture converted from
  163. 'globe.jpg' of NASA. Program & image are on harddisk.)
  164.  
  165. These are just typical values. The differences in speed become smaller with smaller
  166. images and larger if the image is on ram-disk.
  167.  
  168.  
  169.  
  170. Revisions
  171. ---------
  172.  
  173.     1.0    -    first public release
  174.  
  175.     1.1    -    added support for interlaced images
  176.             now fills background with darkest color
  177.  
  178.     1.2    -    file requester added
  179.  
  180.  
  181.  
  182. Address
  183. -------
  184.  
  185. I can be reached at
  186.  
  187. Roman Hiestand
  188. Luziaweg 15
  189. CH-8807 Freienbach
  190. Switzerland
  191.  
  192. Fax: CH-055/48 26 37
  193.  
  194. email: rhiestan@iiic.ethz.ch
  195.